home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / FAQSYS18.ZIP / FAQS.DAT / BMP.TXT < prev    next >
Text File  |  1996-01-04  |  19KB  |  454 lines
  1. BITMAPFILEHEADER  [3.0]
  2.  
  3. Bitmap File Information
  4. The BITMAPFILEHEADER data structure contains information about the type, 
  5. size, and layout of a device-independent bitmap (DIB) file.
  6.  
  7. typedef struct tagBITMAPFILEHEADER {
  8.         WORD    bfType;
  9.         DWORD   bfSize;
  10.         WORD    bfReserved1;
  11.         WORD    bfReserved2;
  12.         DWORD   bfOffBits;
  13. } BITMAPFILEHEADER;
  14.  
  15. The BITMAPFILEHEADER data structure contains the following fields:
  16.  
  17. Field        Description
  18. bfType        Specifies the type of file. It must be BM.
  19. bfSize        Specifies the size in DWORDs of the file. 
  20. bfReserved1    Is reserved and must be set to zero. 
  21. bfReserved2    Is reserved and must be set to zero. 
  22. bfOffBits    Specifies in bytes the offset from the BITMAPFILEHEADER 
  23.         of the actual bitmap in the file. 
  24.  
  25. Comments    A BITMAPINFO or BITMAPCOREINFO data structure immediately 
  26. follows the BITMAPFILEHEADER structure in the DIB file.
  27.  
  28.  
  29. BITMAPINFO  [3.0]
  30.  
  31. Device-Indpendent Bitmap Information
  32. The BITMAPINFO structure fully defines the dimensions and color 
  33. information for a Windows 3.0 device-independent bitmap.
  34.  
  35. typedef struct tagBITMAPINFO { 
  36.    BITMAPINFOHEADER    bmiHeader;
  37.    RGBQUAD             bmiColors[1];
  38. } BITMAPINFO;
  39.  
  40. The BITMAPINFO structure contains the following fields:
  41.  
  42. Field    Description
  43. bmiHeader    Specifies a BITMAPINFOHEADER data structure that 
  44.         contains information about the dimensions and color                 format of a device-independent bitmap. 
  45. bmiColors    Specifies an array of RGBQUAD data structures that 
  46.         define the colors in the bitmap.  
  47.  
  48. Comments:    A Windows 3.0 device-independent bitmap consists of two 
  49. distinct parts: a BITMAPINFO data structure that describes the dimensions 
  50. and colors of the bitmap, and an array of bytes that define the pixels of 
  51. the bitmap. The bits in the array are packed together, but each scan line 
  52. must be zero-padded to end on a LONG boundary. Segment boundaries can 
  53. appear anywhere in the bitmap, however. The origin of the bitmap is the 
  54. lower-left corner.
  55.  
  56. The biBitCount field of the BITMAPINFOHEADER structure determines the 
  57. number of bits which define each pixel and the maximum number of colors 
  58. in the bitmap. This field may be set to any of the following values:
  59.  
  60. Value    Meaning
  61. 1    The bitmap is monochrome, and the bmiColors field must 
  62.     contain two entries. Each bit in the bitmap array represents a 
  63.     pixel. If the bit is clear, the pixel is displayed with the
  64.      color of the first entry in the bmiColors table; if the bit is
  65.      set, the pixel has the color of the second entry in the table.
  66. 4    The bitmap has a maximum of 16 colors, and the bmiColors 
  67.     field contains up to 16 entries. Each pixel in the bitmap is 
  68.     represented by a four-bit index into the color table.
  69.     For example, if the first byte in the bitmap is 0x1F,  then the 
  70.     byte represents two pixels. The first pixel contains the color 
  71.     in the second table entry, and the second pixel contains the 
  72.     color in the 16th table entry.
  73. 8    The bitmap has a maximum of 256 colors, and the bmiColors 
  74.     field contains up to 256 entries. In this case, each byte in the 
  75.     array represents a single pixel.
  76. 24    The bitmap has a maximum of 2^24 colors. The bmiColors 
  77.     field is NULL, and each three bytes in the bitmap array 
  78.     represents the relative intensities of red, green, and blue, 
  79.     respectively, of a pixel.
  80.  
  81. The biClrUsed field of the BITMAPINFOHEADER structure specifies the number
  82. of color indexes in the color table actually used by the bitmap. If the 
  83. biClrUsed field is set to 0, the bitmap uses the maximum number of colors 
  84. corresponding to the value of the biBitCount field.
  85.  
  86. The colors in the bmiColors table should appear in order of importance.
  87.  
  88. Alternatively, for functions that use device-independent bitmaps, the 
  89. bmiColors field can be an array of 16-bit unsigned integers that specify 
  90. an index into the currently realized logical palette instead of explicit 
  91. RGB values. In this case, an application using the bitmap must call 
  92. device-independent bitmap functions with the wUsage parameter set to 
  93. DIB_PAL_COLORS.
  94.  
  95. Note:    The bmiColors field should not contain palette indices if the 
  96. bitmap is to be stored in a file or transferred to another application. 
  97. Unless the application uses the bitmap exclusively and under its complete 
  98. control, the bitmap color table should contain explicit RGB values.
  99.  
  100. BITMAPINFOHEADER  [3.0]
  101.  
  102. Device-Independent Bitmap Format Information
  103. The BITMAPINFOHEADER structure contains information about the dimensions 
  104. and color format of a Windows 3.0 device-independent bitmap.
  105.  
  106. typedef struct tagBITMAPINFOHEADER{
  107.    DWORD  biSize;
  108.    DWORD  biWidth;
  109.    DWORD  biHeight;
  110.    WORD   biPlanes;
  111.    WORD   biBitCount
  112.    DWORD  biCompression;
  113.    DWORD  biSizeImage;
  114.    DWORD  biXPelsPerMeter;
  115.    DWORD  biYPelsPerMeter;
  116.    DWORD  biClrUsed;
  117.    DWORD  biClrImportant;
  118. } BITMAPINFOHEADER;
  119.  
  120. The BITMAPINFOHEADER structure has the following fields:
  121.  
  122. Field        Description
  123. biSize        Specifies the number of bytes required by the 
  124.         BITMAPINFOHEADER structure. 
  125. biWidth        Specifies the width of the bitmap in pixels. 
  126. biHeight    Specifies the height of the bitmap in pixels. 
  127. biPlanes    Specifies the number of planes for the target device and
  128.          must be set to 1. 
  129. biBitCount    Specifies the number of bits per pixel. This value must 
  130.         be 1, 4, 8, or 24. 
  131. biCompression    Specifies the type of compression for a compressed     
  132.         bitmap. It can be one of the following values:.
  133.         Value        Meaning
  134.         BI_RGB        Specifies that the bitmap is not 
  135.                 compressed.
  136.         BI_RLE8        Specifies a run-length encoded format 
  137.                 for bitmaps with 8 bits per pixel. The 
  138.                 compression format is a two-byte 
  139.                 format consisting of a count byte 
  140.                 followed by a byte containing a color 
  141.                 index. See the following 'Comments' 
  142.                 section for more information.
  143.         BI_RLE4        Specifies a run-length encoded format 
  144.                 for bitmaps with 4 bits per pixel. The 
  145.                 compression format is a two-byte 
  146.                 format consisting of a count byte 
  147.                 followed by two word-length color 
  148.                 indexes. See the following 'Comments' 
  149.                 section for more information.
  150. biSizeImage    Specifies the size in bytes of the image. 
  151. biXPelsPerMeter    Specifies the horizontal resolution in pixels per meter             of the target device for the bitmap. An application can             use this value to select a bitmap from a resource group             that best matches the characteristics of the current                 device. biYPelsPerMeter    Specifies the vertical                     resolution in pixels per meter of the target device for             the bitmap. 
  152. biClrUsed    Specifies the number of color indexes in the color table 
  153.         actually used by the bitmap. If this value is 0, the     
  154.         bitmap uses the maximum number of colors corresponding     
  155.         to the value of the biBitCount field. See the         
  156.         description of the BITMAPINFO data structure earlier in     
  157.         this chapter for more information on the maximum sizes 
  158.         of the color table. If biClrUsed is nonzero, then the 
  159.         biClrUsed field specifies the actual number of colors 
  160.         which the graphics engine or device driver will access 
  161.         if the biBitCount field is less than 24. If the     
  162.         biBitCount field is set to 24, the biClrUsed field     
  163.         specifies the size of the reference color table used to 
  164.         optimize performance of Windows color palettes.
  165.         If the bitmap is a 'packed' bitmap (that is, a bitmap in 
  166.         which the bitmap array immediately follows the     
  167.         BITMAPINFO header and which is referenced by a single     
  168.         pointer), the biClrUsed field must be set to 0 or to the 
  169.         actual size of the color table. 
  170. biClrImportant    Specifies the number of color indexes that are considered 
  171.         important for displaying the bitmap. If this value is 0,     
  172.         then all colors are important. 
  173.  
  174. Comments:    The BITMAPINFO data structure combines the 
  175. BITMAPINFOHEADER structure and a color table to provide a complete 
  176. definition of the dimensions and colors of a Windows 3.0 
  177. device-independent bitmap. See the description of the BITMAPINFO data 
  178. structure for more information about specifying a Windows 3.0 
  179. device-independent bitmap.
  180.  
  181. An application should use the information stored in the biSize field to 
  182. locate the color table in a BITMAPINFO data structure with a method such 
  183. as the following:
  184.  
  185. pColor = ((LPSTR) pBitmapInfo + (WORD) (pBitmapInfo -> biSize))
  186.  
  187. Bitmap Compression Formats    Windows supports formats for compressing 
  188. bitmaps that define their colors with 8 bits per pixel and with 4 bits 
  189. per pixel. Compression reduces the disk and memory storage required for 
  190. the bitmap. The following paragraphs describe these formats.
  191.  
  192. When the biCompression field is set to BI_RLE8, the bitmap is compressed 
  193. using a run-length encoding format for an 8-bit bitmap. This format may 
  194. be compressed in either of two modes:
  195.  
  196. 7    Encoded
  197. 7    Absolute
  198.  
  199.  
  200. Both modes can occur anywhere throughout a single bitmap.
  201.  
  202. Encoded mode consists of two bytes:  the first byte specifies the number 
  203. of consecutive pixels to be drawn using the color index contained in the 
  204. second byte. In addition, the first byte of the pair can be set to zero 
  205. to indicate an escape that denotes an end of line, end of bitmap, or a 
  206. delta. The interpretation of the escape depends on the value of the 
  207. second byte of the pair. The following list shows the meaning of the 
  208. second byte:
  209.  
  210. Second Byte
  211. Of Escape    
  212.         Meaning
  213. 0        End of line.
  214. 1        End of bitmap.
  215. 2        Delta. The two bytes following the escape contain
  216.          unsigned values indicating the horizontal and vertical
  217.          offset of the next pixel from the current position.
  218.  
  219. Absolute mode is signalled by the first byte set to zero and the second 
  220. byte set to a value between 03H and FFH. In absolute mode, the second 
  221. byte represents the number of bytes which follow, each of which contains
  222. the color index of a single pixel. When the second byte is set to 2 or 
  223. less, the escape has the same meaning as in encoded mode. 
  224. In absolute mode, each run must be aligned on a word boundary.
  225.  
  226. The following example shows the hexadecimal values of an 8-bit compressed 
  227. bitmap:
  228.  
  229. 03 04 05 06 00 03 45 56 67 00 02 78 00 02 05 01 
  230. 02 78 00 00 09 1E 00 01
  231.  
  232. This bitmap would expand as follows (two-digit values represent a color 
  233. index for a single pixel):
  234.  
  235. 04 04 04
  236. 06 06 06 06 06
  237. 45 56 67
  238. 78 78
  239. move current position 5 right and 1 down
  240. 78 78
  241. end of line
  242. 1E 1E 1E 1E 1E 1E 1E 1E 1E 
  243. end of RLE bitmap
  244.  
  245. When the biCompression field is set to BI_RLE4, the bitmap is compressed 
  246. using a run-length encoding format for a 4-bit bitmap, which also uses 
  247. encoded and absolute modes. In encoded mode, the first byte of the pair 
  248. contains the number of pixels to be drawn using the color indexes in the 
  249. second byte. The second byte contains two color indexes, one in its 
  250. high-order nibble (that is, its low-order four bits) and one in its 
  251. low-order nibble. The first of the pixels is drawn using the color 
  252. specified by the high-order nibble, the second is drawn using the color 
  253. in the low-order nibble, the third is drawn with the color in the 
  254. high-order nibble, and so on, until all the pixels specified by the 
  255. first byte have been drawn.
  256.  
  257. In absolute mode, the first byte contains zero, the second byte contains 
  258. the number of color indexes that follow, and subsequent bytes contain 
  259. color indexes in their high- and low-order nibbles, one color index for 
  260. each pixel. In absolute mode, each run must be aligned on a word boundary.
  261. The end-of-line, end-of-bitmap, and delta escapes also apply to BI_RLE4.
  262.  
  263. The following example shows the hexadecimal values of a 4-bit compressed 
  264. bitmap:
  265.  
  266. 03 04 05 06 00 06 45 56 67 00 04 78 00 02 05 01 
  267. 04 78 00 00 09 1E 00 01
  268.  
  269. This bitmap would expand as follows (single-digit values represent a 
  270. color index for a single pixel):
  271.  
  272. 0 4 0
  273. 0 6 0 6 0 
  274. 4 5 5 6 6 7
  275. 7 8 7 8
  276. move current position 5 right and 1 down
  277. 7 8 7 8
  278. end of line
  279. 1 E 1 E 1 E 1 E 1
  280. end of RLE bitmap
  281.  
  282. RGBQUAD  [3.0]
  283.  
  284. RGB Color Structure
  285. The RGBQUAD data structure describes a color consisting of relative 
  286. intensities of red, green, and blue. The bmiColors field of the 
  287. BITMAPINFO data structure consists of an array of RGBQUAD data structures.
  288.  
  289. typedef struct tagRGBQUAD {
  290.    BYTE    rgbBlue;
  291.    BYTE    rgbGreen;
  292.    BYTE    rgbRed;
  293.    BYTE    rgbReserved;
  294. } RGBQUAD;
  295.  
  296. The RGBQUAD structure contains the following fields:
  297.  
  298. Field        Description
  299. rgbBlue        Specifies the intensity of blue in the color. 
  300. rgbGreen    Specifies the intensity of green in the color. 
  301. rgbRed        Specifies the intensity of red in the color. 
  302. rgbReserved    Is not used and must be set to zero. 
  303.  
  304.  
  305.  
  306. #define BI_RGB      0L
  307. #define BI_RLE8     1L
  308. #define BI_RLE4     2L
  309.  
  310. BITMAPCOREINFO  [3.0]
  311.  
  312. Device-Indpendent Bitmap Information
  313. The BITMAPCOREINFO structure fully defines the dimensions and color 
  314. information for a device-independent bitmap that is compatible with 
  315. Microsoft OS/2 Presentation Manager versions 1.1 and 1.2 bitmaps.
  316.  
  317. typedef struct _BITMAPCOREINFO {
  318.         BITMAPCOREHEADER  bmciHeader;
  319.         RGBTRIPLE         bmciColors[];
  320. } BITMAPCOREINFO;
  321.  
  322. The BITMAPCOREINFO structure contains the following fields:
  323.  
  324. Field    Description
  325. bmciHeader    Specifies a BITMAPCOREHEADER data structure that 
  326.         contains information about the dimensions and color 
  327.         format of a device-independent bitmap. 
  328. bmciColors    Specifies an array of RGBTRIPLE data structures that 
  329.         define the colors in the bitmap.  
  330.  
  331. Comments    An OS/2 Presentation Manager device-independent bitmap 
  332. consists of two distinct parts:  a BITMAPCOREINFO data structure that 
  333. describes the dimensions and colors of the bitmap, and an array of bytes 
  334. which define the pixels of the bitmap. The bits in the array are packed 
  335. together, but each scan line must be zero-padded to end on a LONG 
  336. boundary. Segment boundaries can appear anywhere in the bitmap, however. 
  337. The origin of the bitmap is the lower-left corner.
  338.  
  339. The bcBitCount field of the BITMAPCOREHEADER structure determines the 
  340. number of bits which define each pixel and the maximum number of colors 
  341. in the bitmap. This field may be set to any of the following values:
  342.  
  343. Value    Meaning
  344. 1    The bitmap is monochrome, and the bmciColors field must 
  345.     contain two entries. Each bit in the bitmap array represents a 
  346.     pixel. If the bit is clear, the pixel is displayed with the 
  347.     color of the first entry in the bmciColors table; if the bit is 
  348.     set, the pixel has the color of the second entry in the table.
  349. 4    The bitmap has a maximum of 16 colors, and the bmciColors 
  350.     field contains 16 entries. Each pixel in the bitmap is represented 
  351.     by a four-bit index into the color table.
  352.     For example, if the first byte in the bitmap is 0x1F,  then the 
  353.     byte represents two pixels. The first pixel contains the color in 
  354.     the second table entry, and the second pixel contains the color 
  355.     in the 16th table entry.
  356. 8    The bitmap has a maximum of 256 colors, and the bmciColors 
  357.     field contains 256 entries. In this case, each byte in the array 
  358.     represents a single pixel.
  359. 24    The bitmap has a maximum of 2^24 colors. The bmciColors 
  360.     field is NULL, and each three bytes in the bitmap array 
  361.     represents the relative intensities of red, green, and blue, 
  362.     respectively, of a pixel.
  363.  
  364. The colors in the bmciColors table should appear in order of importance.
  365.  
  366. Alternatively, for functions that use device-independent bitmaps, the 
  367. bmciColors field can be an array of 16-bit unsigned integers that 
  368. specify an index into the currently realized logical palette instead of 
  369. explicit RGB values. In this case, an application using the bitmap must 
  370. call device-independent bitmap functions with the wUsage parameter 
  371. set to DIB_PAL_COLORS.
  372.  
  373. Note    The bmciColors field should not contain palette indexes if the 
  374. bitmap is to be stored in a file or transferred to another application. 
  375. Unless the application uses the bitmap exclusively and under its 
  376. complete control, the bitmap color table should contain explicit 
  377. RGB values.
  378.  
  379.  
  380.  
  381. BITMAPCOREHEADER  [3.0]
  382.  
  383. Device-Independent Bitmap Format Information
  384. The BITMAPCOREHEADER structure contains information about the dimensions 
  385. and color format of a device-independent bitmap that is compatible with 
  386. Microsoft OS/2 Presentation Manager versions 1.1 and 1.2 bitmaps.
  387.  
  388. typedef struct tagBITMAPCOREHEADER {
  389.         DWORD   bcSize;
  390.         WORD    bcWidth;
  391.         WORD    bcHeight;
  392.         WORD    bcPlanes;
  393.         WORD    bcBitCount;
  394. } BITMAPCOREHEADER;
  395.  
  396. The BITMAPCOREHEADER structure has the following fields:
  397.  
  398. Field        Description
  399. bcSize        Specifies the number of bytes required by the BITMAPCOREHEADER 
  400.         structure. 
  401. bcWidth        Specifies the width of the bitmap in pixels. 
  402. bcHeight    Specifies the height of the bitmap in pixels. 
  403. bcPlanes    Specifies the number of planes for the target device and 
  404.         must be set to 1. 
  405. bcBitCount    Specifies the number of bits per pixel. This value must 
  406.         be 1, 4, 8, or 24. 
  407.  
  408. Comments    The BITMAPCOREINFO data structure combines the 
  409. BITMAPCOREHEADER structure and a color table to provide a complete 
  410. definition of the dimensions and colors of a device-independent bitmap. 
  411. See the description of the BITMAPCOREINFO data structure for more 
  412. information about specifying a device-independent bitmap.
  413.  
  414. An application should use the information stored in the bcSize field to 
  415. locate the color table in a BITMAPCOREINFO data structure with a method 
  416. such as the following:
  417.  
  418. pColor = ((LPSTR) pBitmapCoreInfo + (WORD) (pBitmapCoreInfo -> bcSize))
  419.  
  420.  
  421.  
  422. RGBTRIPLE  [3.0]
  423.  
  424. RGB Color Structure
  425. The RGBTRIPLE data structure describes a color consisting of relative 
  426. intensities of red, green, and blue. The bmciColors field of the 
  427. BITMAPCOREINFO data structure consists of an array of RGBTRIPLE data 
  428. structures.
  429.  
  430. typedef struct tagRGBTRIPLE {
  431.         BYTE    rgbtBlue;
  432.         BYTE    rgbtGreen;
  433.         BYTE    rgbtRed;
  434. } RGBTRIPLE;
  435.  
  436. The RGBTRIPLE structure contains the following fields:
  437.  
  438. Field        Description
  439. rgbtBlue    Specifies the intensity of blue in the color. 
  440. rgbtGreen    Specifies the intensity of green in the color. 
  441. rgbtRed        Specifies the intensity of red in the color. 
  442.  
  443.  
  444.  
  445. -----------------------------------------------------------------------
  446.  
  447.     Non official comments
  448.  
  449. How to distinguish between BITMAPINFO and BITMAPCOREINFO when reading
  450. in a BMP file.
  451.  
  452. After reading the BITMAPFILEHEADER read the next DWORD from the file. 
  453. If it is 12 you are reading a BITMAPCOREHEADER, if it is 40 you are
  454. reading a BITMAPINFOHEADER.